主题
图像数据库模块总览 - Overview
本分类做什么
在插件管理的 ola 图像数据库 中完成 初始化、按目录批量导入/导出、按键读写与删除。供 图像识别 等接口 优先从库取模板，减少散落文件路径。底层仍依赖 数据库 连接与默认库配置。
一、初始化与批量
| 接口 | 差异 |
|---|---|
| InitOlaDatabase | 初始化 ola 相关 库结构（表/索引以详情页为准）。 |
| InitOlaImageFromDir | 从 目录 批量导入图片进库。 |
| RemoveOlaImageFromDir | 按 目录键 批量删除库内记录。 |
| ExportOlaImageDir | 将某 逻辑目录 下条目导出到磁盘。 |
选型：首次部署 → InitOlaDatabase + InitOlaImageFromDir；清理某批资源 → RemoveOlaImageFromDir；备份 → ExportOlaImageDir。
二、单条维护
| 接口 | 差异 |
|---|---|
| ImportOlaImage | 写入/更新 一条图元数据与二进制（见详情页）。 |
| GetOlaImage | 读取 一条。 |
| RemoveOlaImage | 删除 一条。 |
与批量接口差异：单条适合 运行时动态增删；批量适合 资源整包同步。
三、与「通用数据库」模块的分工
| 对比 | 图像数据库（本分类） | 数据库（通用 SQL） |
|---|---|---|
| 抽象层级 | 键/目录/图 业务封装 | 任意 SQL |
| 典型用户 | 做 找图模板库 的脚本作者 | 字库表、业务表、通用查询 |
若需 复杂联表查询，可能仍要用 ExecuteReader 直接访问底层表（表名见插件文档）。
四、配置依赖
- 设置 中 DbPath、默认库等与 OpenDatabase 行为相关；db 句柄传 0 时常读默认库。
五、快速选型
| 需求 | 建议 |
|---|---|
| 找图模板改走数据库 | InitOlaImageFromDir 导入 + 识别接口使用库模式（见识别文档） |
| 热更新单张模板 | ImportOlaImage / RemoveOlaImage |